窗口-页签-字段

内容

概述
窗口-window
页签-tab
字段-field

概述

窗口-window

1. 窗口类型：
维护Maintain: 窗口允许用户新增或者修改记录。大多数主数据或者索引数据的维护都是通过此类窗口完成。比如：产品，银行。默认必须含“processed”字段。
只读Query Only: 窗口只允许显示信息，禁止新增或者更新数据。比如：会计分录，访问审计。
事务Transaction: 窗口用于模块事务处理，通常会有后续的流程处理，比如日记账，订单或者其他单据窗口。

2. 销售事务：isSOTrx，缺省是Y。窗口的isSOTrx属性用来区分类似”采购/销售“”出库/入库“同表异用界面。
select name, issotrx from ad_window 
where isactive='Y' 
ORDER BY 2,1                                      /\* 356 条记录 \*/

菜单映射了窗口信息，也同样有isSOTrx属性，缺省值也是Y。
select name, issotrx from ad_menu 
where isactive='Y' and action='W'
ORDER BY 2,1                                       /\* 335 条记录 \*/

但2者好像不是很吻合的记录有127条，menu的issotrx没有太多用处，个人感觉可以同步这127记录。
select a.name menu_name, b.name win_name, 
a.issotrx menu_issotrx, b.issotrx win_issotrx,
a.ad_window_id menu_wid, b.ad_window_id win_wid,
a.isactive menu_isactive, b.isactive win_isactive
from ad_menu a
join ad_window b
on a.ad_window_id=b.ad_window_id
where a.isactive='Y' and b.isactive='Y' 
AND a.issotrx <> b.issotrx                   /\* 2个不一样的地方 \*/
order by 4,1                                         /\* 127条数据           \*/

关于isSOTrx
isSOTrx还会在如下场景使用： SELECT a.Name, b.name, b.tablename ,b.accesslevel, a.IsMandatory, a.defaultvalue FROM AD_Column a join ad_table b on a.ad_table_id=b.ad_table_id WHERE a.columnname='IsSOTrx' and b.tablename !~ '^I_' and b.isview ='N' ORDER BY 4 desc 从表的访问层级，大致分2类：系统场景和单据场景 ==系统场景用途：翻译取词 element具有2套词义，name，desc，help，po_name，po_desc , po_help 通过判断element出现场所的isSOTrx属性，element相应使用不同的词义。比如：isSOTrx=Y，词义=Name，isSOTrx=N，词义=PO_Name ==单据场景用途：数据筛选某些比如C_Order（采购/销售订单），M_InOut（收货/发货单），其单据具有isSOTrx属性。在TAB的sql where 字段填入“C_Order.IsSOTrx='Y'”，即可以区分同表异用事务的单据数据。比如：Zoom Logic Table>Zoom Condition，对某个column缩放到某个窗口，可以根据单据记录的isSOTrx属性来条件选择。比如：search define 定义search code，对某个复用表进行窗口弹出时，也是根据单据记录的isSOTrx属性来分窗口弹出。

窗口的页签通常分级来表示表头-明细，也有多表头无明细窗口 （tablevel都是0），比如：

select a.ad_window_id , b.name,count(a.ad_window_id) as tab_count , sum(a.tablevel) from ad_tab a join ad_window b
on a.ad_window_id=b.ad_window_id
group by a.ad_window_id,b.name
having count(a.ad_window_id) > 1 and sum(a.tablevel)=0
order by 3

结果：
53016,ASP Subscribed Modules,2,0
326,Access Audit,2,0
283,Accounting Dimensions,7,0

关于固定字段
ad_client_id 实体 ad_org_id 组织 created 创建人 createdby 创建时间 updated 更新人 updatedby 更新时间 isacitive 有效从table拷贝field到tab，会自动忽略拷贝这7个字段（不是不显示，是不拷贝到tab）。因为有单独的记录信息来显示，通过点击记录链接可以得到。如果非要tab显示这些field，比如创建人，创建时间，需要单独新增需要的固定字段。如果自己建表，最快的办法是直接拷贝系统已有的一个简单表，比如ad_orgtype

页签-tab

==关键选项==
翻译页签：如果实体启用多语种支持，相应的翻译页签将显示。正常页签不能设置改选项，否则报权限不够。
排序页签：比如打印格式排序页签。
高级页签：特殊的页签分类，供角色的IsAccessAdvanced选项使用。
会计页签：和财务会计相关的页签，系统默认有53个。
Process：流程和报表，通常用作报表，页签会出现打印按钮，否则打印图标只读。
has tree：页签是否包含树。比如组织、科目元素之类的页签
tab level：页签的层次。从0开始。

Included_Tab：如果使用level层来定义window和tab的包含关系，可以直接使用该选项来包含一个子tab，但是现版本只有一个案例Expense Invoice (Alpha)窗口，Invoice页签包含Included Lines页签。参考：https://blogs.walkingtree.tech/2012/06/17/included-tabs-as-horizontal-tab-in-adempiere/ 。

==Link column==
Link column：如果子表没有主键，在子表的TAB中，指定用于链接到父表的列。如下图。

What about Explicit and Implicit Parents?
If the Child Table has one Parent: Link automatically; no action is required.
If the Child Table has two or no Parents: Explicit Link is required (Tab: Link Column)

select a.name TAB_NAME, a.tablevel , a.ad_column_id Link_Column ,b.columnname Link_Column_id,b.name Link_Column_name, a.Parent_Column_ID from ad_tab a
inner join ad_column b on a.ad_column_id=b.ad_column_id
where a.AD_Column_ID is not null ORDER BY 4 ;

==Parent Column==
Parent Column: 子表TAB可以指定父页签的链接键，显式表示两表关系。
https://sourceforge.net/p/adempiere/feature-requests/741/

实际上是sql语句的： join 子表名 ON 父键=子键， 通常父键和子键都是同名的，比如2个表都有Ad_Org_ID , 如果这样，父键不需要设置，但是如果2键不一样，就需要设置父键，比如：AD_User.AD_User_ID=C_Order.SalesRep_ID。已有记录如下:

select b.name,a.name,a.Parent_Column_ID from ad_tab a
join ad_window b on a.ad_window_id=b.ad_window_id
where a.Parent_Column_ID is not null;

####Tab toolbar
以前要挂一个process，必须使用表中的一个空字段（通常是Procssing字段，名字叫Process Now）显示为按钮，这个按钮字段可以放置在窗口或者TAB工具栏上。1.0后TAB也可以在设置中使用“添加工具栏按钮”功能，参考TabEditor或者使用select name from AD_ToolBarButton查询更多的例子。2者各有优缺点，TAB方式方便快捷，字段按钮方式可以放在窗口中间，方便用户操作。

自定义窗口挂上TabEditor结果无法正确取到下面的字段TAB列表，比如：AD_Tab_ID=395，编辑器取 AD_Tab_ID=1000003字段。

参考：ADTabPanel.java

父子表链接（表头明细设置）
1. 快速链接父子表表设置主表： head_id (主键列isKey) 子表： line_id（主键列isKey），head_id（isParent） TAB设置：主表tab层=0 子表tab层=1 2. 已有配置 Table-Column： Key column（isKey，737条），Parent link column（IsParent，727条），且2着互斥。 Window-TAB : link column （330条）， Parent column （6条记录） 3. Column设置：isKey表示单主键表还是多主键表（多主键表无需设置列为isKey）。IsParent，在子表的列上设置，表示用该键与父表关联。 4. Window-Tab设置：都在子表TAB上设置，都在子表TAB上设置，都在子表TAB上设置。如果子表是单外键表（isparent数量=1），系统自动匹配（子表的isParent列找父表的同名列）。如果子表是多外键表（isparent数量>1），则需要进一步指定子表TAB用哪个link column找父表。如果不是匹配父表的同名列，还需在子表TAB上指定父表的Parent link（比如，link列=sales_id，parent列=ad_user_id）。

隐藏的对象_WinInfo_，_TabInfo_
每个窗口、页签还有一个各自隐藏的对象，可以从上下文获取隐藏对象的字段信息。比如最后3列为1窗口的隐藏字段，页签也是同理，更多信息访问本次会话的上下文。 1|AD_Client_ID == 11 1|AD_CtxHelp_ID == 1000006 1|AD_CtxHelp_UU == f7597ab8-b9dd-496f-b24d-f7f5d61bc8b8 1|AD_Org_ID == 0 1|AutoCommit == Y 1|AutoNew == Y 1|BaseTable_ID == 200063 1|Created == 2017-05-19 11:45:45 1|CreatedBy == 101 1|CtxType == H 1|Find_Table_ID == 200063 1|IsActive == N 1|IsSOTrx == Y 1|Name == Getting Started 1|Updated == 2017-08-18 14:31:31 1|UpdatedBy == 101 1|WindowName == 自定义帮助 1|_WinInfo_AD_Window_ID == 200034 1|_WinInfo_AD_Window_UU == 9da664a6-1cde-4908-a3fe-ba367c04f851 1|_WinInfo_WindowName == 自定义帮助

字段-field

==Zoom In==
1. 字段Reference中数据来源table direct到某个表，如果用户对此表无权限，将不显示“Zoom In”链接。
2. 如果该字段是视图，id已经是join表后取值为name，没有继续引用表，则也不显示“Zoom In”链接。

==Reference Overwrite：覆盖引用==
 Reference Overwrite：覆盖引用，即可以在tab级别（而不是column级别）进行取值过滤。
比如：一个表，2个用途，在2个window-tab中某个字段field的取值各不相同，使用RefOverWrite覆盖原column取值。
https://groups.google.com/d/msg/idempiere/-DrXI2vAbz8/eutwHSIEPzAJ

==按钮字段名字==
常见的几个按钮字段，按钮显示的文本与field无关，与挂的流程有关。

功能                       filed                                             column                   element
单据处理          Process Depreciation Entry              DocAction               DocAction
单据过账          Posted                                              Posted                     Posted
工作流             Process Now                                     Processing              Processing

还有一个很容易混淆的字段，ProcessOn，这是记录单据的纳秒时间，十进制格式。
对于单据，通常还有 processed 和 processing 两个字段
对于过账，通常还要 posted 和 ProcessOn 两个字段

如果你新建了一个流程process，看看系统如何使用field和column的。
select a.name field_name , b.name col_name, c.name process_name,c.classname from ad_field a
join ad_column b on a.ad_column_id=b.ad_column_id
join ad_process c on b.ad_process_id=c.ad_process_id
where  a.isactive='Y' AND b.isactive='Y' and c.isactive='Y'
AND b.ad_process_id is not null
order by 2

系统支持在菜单栏直接挂流程，而不用新建field来挂column再挂process，唯一遗憾就是不直观。

==字段显示==
isdisplay：是否在单行模式下显示
displaylogic：单行模式下的显示逻辑
isdisplayedgrid：是否在网格模式下显示，不受前2者影响，只受“自定义显示”定义。
测试“通知”窗口，无论单行模式的字段显示如何变化，网格显示不变。

// IDEMPIERE-2204 
add field in tabCustomization list to display list event this field have showInGrid = false

==记录排序：SortNo==
SortNo：排序顺序，order by 后面的顺序，从1开始，“-”表示desc降序，设置后，需要清理缓存。
（好记性不如烂笔头，忘记在这里了）
【注意】页签也有orderbyclause字段设置数据的排序。和SortNo一起都加在sql后面，没有区别。

关于字段下划线链接
在每个页签的字段都提供链接缩放功能，如果角色对表有正确的访问权限。该权限由表访问等级、角色访问等级共同决定。参考[访问控制](http://idempiere_guide_sm.mydoc.io?v=${version}&t=186541#widget_5312007